home *** CD-ROM | disk | FTP | other *** search
/ Trading on the Edge / Trading On The Edge - CD-ROM Toolkit (Wayzata Technology)(2031)(1994).bin / pc / mac_file / vendor_d / rommaker / rommaker._he / cards.xml < prev    next >
Text File  |  1992-09-03  |  73KB  |  673 lines

  1. card_36026.xml
  2. <?xml version="1.0" encoding="utf-8" ?>
  3. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  4. <card>
  5.     <id>36026</id>
  6.     <filler1>0</filler1>
  7.     <cantDelete> <false /> </cantDelete>
  8.     <showPict> <true /> </showPict>
  9.     <dontSearch> <false /> </dontSearch>
  10.     <owner>31568</owner>
  11.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  12.     <content>
  13.         <layer>background</layer>
  14.         <id>2</id>
  15.         <text>Utilities</text>
  16.     </content>
  17.     <content>
  18.         <layer>background</layer>
  19.         <id>3</id>
  20.         <text>p. 15 of 15</text>
  21.     </content>
  22.     <content>
  23.         <layer>background</layer>
  24.         <id>7</id>
  25.         <text>COPYING & COMPARING IMAGESThe Copy Image option allows you to copy all or part of a premastered image to another medium.  You can copy a premastered image from:         - DATA/DAT tape         - WCD-ROM hard disk image         - disk file         - CD-ROMto one of the following media:         - DATA/DAT tape         - WCD-ROM hard disk image         - disk fileThis feature is useful for example in copying the premastered image from tape to a disk file. The mastering plants accepting DATA/DAT tapes in fact use this utility to transfer your CD-ROM image from the DAT cartridge to their replication systems.When you select this option, RomMaker will ask you to specify the source and destination of the image you wish to copy.RomMaker will read the volume header information from the source CD-ROM image and display this on the screen. If the data does not conform to an ISO 9660 or Hi-Sierra image, an error will be reported since this utility can only be used to copy legitimate CD-ROM images from one media to another.The Compare Image option looks through each file and folder on the images being compared and indicates any files that have have different sizes or attributes on one image than their counterparts on the other image. You should run this compare operation on your virtual CD-ROM image after testing but before making the DAT tape. This process can catch any changes that may have occurred to your files after testing completed.FORMAT WCD-ROM HARD DISKIf you purchased a WCD-ROM subsystem, it will have come prepared so that you can immediately start making inhouse CD-ROMs. Occasionally while moving the tower unit or simply because of hard disk failure, you may need to re-prepare the WCD-ROM subsystem. This utility initializes the WCD-ROM subsystem so that RomMaker can use it to produce your CD-ROM's.If you select this option, you will get a warning notice that any data on the WCD-ROM system will be destroyed after which the system will commence a low level initialization of the subsystem. In addition to other system level operations, this process also reformats your hard disk so that any bad sectors are blocked out from future access.You will rarely need to perform this operation, though it is a good idea to re-initialize the WCD-ROM subsystem once every year so that bad data blocks are masked out of regular use.GENERATE CD-ROM DRIVE CHARACTERISTICSThe RomMaker emulation feature mimics a physical CD-ROM in performance by using an algorithm that simulates the behavior of an actual CD player even though the files are coming off a hard disk. This algorithm is used to determine how much delay would have occurred had you been using an actual CD-ROM.Each time you use the emulator, the drive characteristic algorithm is also loaded so that you will get a true feel of how the application you are testing will run on a CD-ROM if you were to produce the CD-ROM. Each time a read request is made to the emulator, it analyzes the request to see where the CD-ROM drive head would have been positioned and delays the read request to the hard disk file appropriately. This algorithmic delay in hard disk access to the translated file provides you with a sophisticated quality assurance capability without actually producing a CD-ROM.RomMaker comes with a set of characteristics to mimic the performance of the commonly available CD-ROM drives. However, given the number of CD-ROM drives already available and the continuing introduction of new models, you may need to build a new algorithm for a drive not in our supplied list.  This option allow you to generate the characteristics algorithm for your drive by running a test pattern on a particular CD player. To generate a new characteristic, follow these steps:1) Hook up the CD-ROM drive that you want to mimic to your Macintosh.  Verify that you can insert a CD-ROM into the drive and read it normally.2) Insert any fully populated (500MB or greater) ISO 9660 or Hi-Sierra compliant CD-ROM available to you into your CD-ROM drive.3) Run RomMaker and choose "Generate CD-ROM drive characteristics..." from the Emulate menu. You will be asked for a name for RomMaker to associate with this drive type; enter any name you like and click OK.RomMaker will then run a test pattern on the CD-ROM drive. This test takes about half an hour and can be cancelled if necessary. When the test is complete, you will be returned to the title form for further action.Note that all title files will not automatically use the new drive characteristics you have just created. You will need to go to the Misc Options section of the title file and specify which drive characteristics to use on a title-by-title basis.</text>
  26.     </content>
  27.     <content>
  28.         <layer>background</layer>
  29.         <id>22</id>
  30.         <text>15</text>
  31.     </content>
  32.     <name>Utilities</name>
  33.     <script></script>
  34. </card>
  35.  
  36.  
  37. card_35540.xml
  38. <?xml version="1.0" encoding="utf-8" ?>
  39. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  40. <card>
  41.     <id>35540</id>
  42.     <filler1>0</filler1>
  43.     <cantDelete> <false /> </cantDelete>
  44.     <showPict> <true /> </showPict>
  45.     <dontSearch> <false /> </dontSearch>
  46.     <owner>31568</owner>
  47.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  48.     <content>
  49.         <layer>background</layer>
  50.         <id>2</id>
  51.         <text>Examine</text>
  52.     </content>
  53.     <content>
  54.         <layer>background</layer>
  55.         <id>3</id>
  56.         <text>p. 14 of 15</text>
  57.     </content>
  58.     <content>
  59.         <layer>background</layer>
  60.         <id>7</id>
  61.         <text><span class="style1">he Examine mehu allows you to view and modify the contents of several text files created and maintained by RomMaker.  RomMaker comes with a built-in text editor; however, if you want to use another one, just make a copy of it, name the copy "Text Editor", and put it in the folder with RomMaker.  The next time you use the Examine menu, RomMaker will open your editor instead of its own.IMPORTANT NOTE:  RomMaker's built-in editor cannot read more than 30,000 bytes from a file; thus if it used to save a very long file, the file will be truncated to 30,000 bytes when saving.ROM CONTENT FILEThis option displays the ROM Content file specified by the currently open title file.USAGE STATISTICS FILEThis option displays the usage statistics file most recently generated by emulating using an image created using the currently-open title file.LOG FILEThis option displays the most recent log file for the current title file. Whenever RomMaker completes a successful Make Rom operation, it produces a log file containing the names and physical locations of each file on the CD-ROM. This file is created in the "LOG" folder within the RomMaker folder, and its name is the volume label specified in the title file, followed by ".LOG", unless otherwise specified in the "Misc Options" section of the title file. The log file contains the name, absolute physical location, size, and attributes for each file placed on the CD-ROM. Here's a sample log file:</span><span class="style5">======================================================================        STATISTICS FOR CD-ROM VOLUME SET 'US__NGA_'            Produced: Mon Jul 13 15:06:58 1992        Total number of CD-ROM Sectors: 2506        First CD-ROM record address: 00:02:00        Last CD-ROM record address: 00:35:30====================================================================== Layout of Volume :'US__NGA_' Creation Started : Mon Jul 13 15:05:35 1992 Finished         : Mon Jul 13 15:06:58 1992Data   Rsrc     Audio Loc      File SizeSector Sector   (mm:ss:ff)   Data    Rsrc  Date/Time Stamp    Attribs------ ------ ------------- ------ ------- ---------------    -------HD:picture library        ->:FOLDER:PICTUREL.IBR   118    118   00:03:43      3248       0 14 Jun 92 23:52:34 'r*'HD:compare disks 10/11/90 ->:FOLDER:COMPARE_.DIS   123    123   00:03:48         0  108711 17 Feb 92 11:32:37 'r*'HD:comparison results     ->:FOLDER:COMPARIS.ON_   178    178   00:04:28      2271       0 27 Jun 92 12:23:23 'r*'</span><span class="style1">...ERROR FILEThis option displays the error file (if any) generated while making the last RomMaker image.A significant class of errors can occur when the ROM Content File is being processed by the RomMaker. These errors usually arise from improper syntax and/or filenames. When you make an image, RomMaker reads the layout or backup script file associated with the title and checks for errors before building the image directory and file structures.RomMaker displays an error window as soon as it encounters the first error. One choice in this error window is to send this and subsequent errors to an error file. If you choose this option, an error file is created in the "LOG" folder within the RomMaker folder.  Its name is the same as the ROM Content File, followed by ".ERR", unless specified otherwise in the "Misc Options" section of the title file.RomMaker will record up to 50 errors before aborting processing.</span></text>
  62.     </content>
  63.     <content>
  64.         <layer>background</layer>
  65.         <id>22</id>
  66.         <text>14</text>
  67.     </content>
  68.     <name>Examine</name>
  69.     <script></script>
  70. </card>
  71.  
  72.  
  73. card_35226.xml
  74. <?xml version="1.0" encoding="utf-8" ?>
  75. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  76. <card>
  77.     <id>35226</id>
  78.     <filler1>0</filler1>
  79.     <cantDelete> <false /> </cantDelete>
  80.     <showPict> <true /> </showPict>
  81.     <dontSearch> <false /> </dontSearch>
  82.     <owner>31568</owner>
  83.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  84.     <content>
  85.         <layer>background</layer>
  86.         <id>2</id>
  87.         <text>Emulate</text>
  88.     </content>
  89.     <content>
  90.         <layer>background</layer>
  91.         <id>3</id>
  92.         <text>p. 13 of 15</text>
  93.     </content>
  94.     <content>
  95.         <layer>background</layer>
  96.         <id>7</id>
  97.         <text><span class="style1">MULATING APPLE & ISO VOLUMESRomMaker provides a unique capability of verifying that you have created the correct CD-ROM before sending it to the mastering plant. Emulation instructs RomMaker to present the image on the Macintosh desktop as if it were a normal CD-ROM. You can choose to emulate either Apple HFS or ISO 9660 volumes, using either the Data-DAT or the RomMaker hard disk as a source image.After choosing one of the above emulation options, the CD-ROM icon will appear on your desktop, and will behave just as a normal CD-ROM would. Use whatever validation process you would with the real CD-ROM to satisfy yourself of the image's worthiness for mastering. You can even share files on an ISO image with a DOS machine over the network (assuming your network supports such an operation).If you created your CD-ROM image using the combined HFS/ISO standard, you can emulate either standard, but only one at a time.COLLECTING & REPORTING USAGE STATISTICSThe emulation feature maintains statistics for each file on the CD-ROM image. These statistics can help you refine the performance of your CD-ROM through better software design, as well as appropriate rearranging of the directory structure, by giving you information on the usage patterns encountered during the emulation session.  Information tracked includes:- Number of file opens per file. This helps you determine whether your application is doing too many file opensΓÇöa CD-ROM function that is particularly costly in terms of access and processing times.- Number of file reads. This indicates how many distinct read requests were sent to the CD-ROM while you were running a particular test or application. This helps you determine the optimum layout of files on a CD-ROM. Files that are read and accessed most often should be placed where access times are  the fastest, which is close to the inner part of the CD-ROM.- Average access time for file reads. This indicates how the CD-ROM is physically being accessed. If the average access time is high, the file is being accessed by the head moving significant distances - that is, the application is reading data from one file and jumping across a large number of tracks to access other files. For optimum performance, files that are read most frequently should be positioned not only close to the inner part of the CD-ROM, but also close to each other.To collect these statistics, follow these steps:1) Create a CD-ROM image, then use the appropriate Emulate menu item.2) Choose "Start collecting usage statistics" from the Emulate menu.2) Run your test or application as if you were testing an actual CD-ROM.3) When testing is finished, choose "Report usage statistics" from the Emulate menu. RomMaker will sort the collected statistics based on number of file reads and then output them to the Usage Statistics File.4) Choose "Usage Statistics File" from the "Examine" menu.  RomMaker will display the statistics file (which will have been created in the "LOG" folder within the RomMaker folder, unless otherwise specified within the Misc Options section of the title file).Here's a sample usage statistics file:</span><span class="style5">     Volume Label: SAMPLE      Produced @ Thu May 23 15:31:15 1991     File   File   Tot. Seek  Avg. Seek     Reads  Opens  Time(sec) Time(msec) CD-ROM FileName     _____ ______ __________ __________ __________________________     00005 000001 0000000001 0000000166 :MyFolder:picture library     00005 000001 0000000001 0000000155 :MyFolder:disk verify     00005 000001 0000000001 0000000166 :MyFolder:disk comparer     00005 000001 0000000001 0000000144 :MyFolder:interest calculator     00005 000001 0000000001 0000000155 :MyFolder:system modes     00004 000001 0000000001 0000000166 :bibliographic file</span><span class="style1">This shows some sample statistics on a test run carried out for an application which opened some files on a CD-ROM. Note that the statistics system does not report any files which have had zero activity; i.e., no file opens and no file reads. The system designer should look at those files carefully as the application appears not to be using these files. Such files are often just remnants of an older system and need to be discarded.After determining from the usage statistics file which CD-ROM files need to be moved closer to one another, you can edit the ROM Content File to change the order in which they will be put on the CD-ROM, since RomMaker processes and copies files in order that they are encountered in the ROM Content File. Often, simply rearranging the ROM Content File is all you need to do to optimize the performance of your CD-ROM.ALLOW CHANGES TO CURRENT IMAGEThis option allows you to make certain changes to the ROM image's desktop appearance.  You may change:   - icon positions within a window   - folder window sizes and positions   - whether folders are open or closedYou should NOT:   - rename or delete any item (file or folder)   - move any item from one folder to another   - alter the contents of any fileAlthough certain of the "forbidden" changes might appear to be allowed, such changes will NOT be saved in the image and may lead to RomMaker processing errors.</span></text>
  98.     </content>
  99.     <content>
  100.         <layer>background</layer>
  101.         <id>22</id>
  102.         <text>13</text>
  103.     </content>
  104.     <name>Emulate</name>
  105.     <script></script>
  106. </card>
  107.  
  108.  
  109. card_34915.xml
  110. <?xml version="1.0" encoding="utf-8" ?>
  111. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  112. <card>
  113.     <id>34915</id>
  114.     <filler1>0</filler1>
  115.     <cantDelete> <false /> </cantDelete>
  116.     <showPict> <true /> </showPict>
  117.     <dontSearch> <false /> </dontSearch>
  118.     <owner>31568</owner>
  119.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  120.     <content>
  121.         <layer>background</layer>
  122.         <id>2</id>
  123.         <text>Make</text>
  124.     </content>
  125.     <content>
  126.         <layer>background</layer>
  127.         <id>3</id>
  128.         <text>p. 12 of 15</text>
  129.     </content>
  130.     <content>
  131.         <layer>background</layer>
  132.         <id>7</id>
  133.         <text>DATA-DAT IMAGEThis option creates an "image" of your CD-ROM on magnetic tape by instructing RomMaker to process the current title file (and the associated ROM Content File), thereby copying all relevant files and folders to the DAT tape in such a way that it is a byte-for-byte copy of the eventual CD-ROM.  After creating such an image, you can test it by using the Emulate menu.WCD-ROM HARD DISK IMAGEThis option creates an "image" of your CD-ROM on the RomMaker hard disk by instructing RomMaker to process the current title file (and the associated ROM Content File), thereby copying all relevant files and folders to the DAT tape in such a way that it is a byte-for-byte copy of the eventual CD-ROM.  After creating such an image, you can test it by using the Emulate menu.CD-ROM FROM WCD-ROM HARD DISK IMAGEThis option replicates the pre-mastered image stored on the WCD-ROM hard disk to a blank CD-ROM in the WCD-ROM drive (thus permanently using up the blank CD, so you probably shouldn't do it until you've tested the image thoroughly using RomMaker's Emulate features).ICON-ONLY IMAGEThis option helps create polished Apple HFS CD-ROMs by allowing you to set up your CD-ROM's desktop information (window positions and sizes, icons, etc) once, just as you want it, and then save that information for later use by RomMaker.  You then don't need to worry about accidentally shifting one of your "original" icons or windows and having a subsequent CD-ROM inadvertently reflect the change.The icon-only image, RomMaker processes the ROM Content File just as it does when making any other type of image, but it doesn't actually transfer any data from within the files it encounters. Instead, it creates a special kind of image in which the desktop information is present but none of the files contain any information. The windows and icons in this special image can be positioned by clicking and dragging just as if it were a normal Macintosh disk. When all the files, folders, and windows are positioned as you want them to be, use the "Make Icon Database..." option (see below) to save this information so that RomMaker can use it when making your actual CD-ROM.ICON DATABASE FROM ICON-ONLY IMAGEOnce you have created and adjusted an icon-only image (see above) to your satisfaction, use this option to save the image's desktop information to a file that RomMaker can use when creating subsequent CD-ROM images.  (Unless you specify otherwise in the "Misc Options" section of the title file, this file will be saved in the "DFN" folder within the RomMaker folder using the name of your volume followed by " ICON DB" (note the two spaces) as the the filename.)</text>
  134.     </content>
  135.     <content>
  136.         <layer>background</layer>
  137.         <id>22</id>
  138.         <text>12</text>
  139.     </content>
  140.     <name>Make</name>
  141.     <script></script>
  142. </card>
  143.  
  144.  
  145. card_34318.xml
  146. <?xml version="1.0" encoding="utf-8" ?>
  147. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  148. <card>
  149.     <id>34318</id>
  150.     <filler1>0</filler1>
  151.     <cantDelete> <false /> </cantDelete>
  152.     <showPict> <true /> </showPict>
  153.     <dontSearch> <false /> </dontSearch>
  154.     <owner>31568</owner>
  155.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  156.     <part>
  157.         <id>2</id>
  158.         <type>field</type>
  159.         <visible> <true /> </visible>
  160.         <dontWrap> <false /> </dontWrap>
  161.         <dontSearch> <true /> </dontSearch>
  162.         <sharedText> <false /> </sharedText>
  163.         <fixedLineHeight> <true /> </fixedLineHeight>
  164.         <autoTab> <false /> </autoTab>
  165.         <lockText> <true /> </lockText>
  166.         <rect>
  167.             <left>324</left>
  168.             <top>80</top>
  169.             <right>442</right>
  170.             <bottom>117</bottom>
  171.         </rect>
  172.         <style>shadow</style>
  173.         <autoSelect> <false /> </autoSelect>
  174.         <showLines> <false /> </showLines>
  175.         <wideMargins> <true /> </wideMargins>
  176.         <multipleLines> <false /> </multipleLines>
  177.         <reservedFamily> 0 </reservedFamily>
  178.         <titleWidth>0</titleWidth>
  179.         <icon>0</icon>
  180.         <textAlign>left</textAlign>
  181.         <font>Geneva</font>
  182.         <textSize>10</textSize>
  183.         <textStyle>plain</textStyle>
  184.         <textHeight>13</textHeight>
  185.         <name>prompt</name>
  186.         <script></script>
  187.     </part>
  188.     <part>
  189.         <id>3</id>
  190.         <type>button</type>
  191.         <visible> <true /> </visible>
  192.         <reserved5> 0 </reserved5>
  193.         <reserved4> 0 </reserved4>
  194.         <reserved3> 0 </reserved3>
  195.         <reserved2> 0 </reserved2>
  196.         <reserved1> 0 </reserved1>
  197.         <enabled> <true /> </enabled>
  198.         <rect>
  199.             <left>444</left>
  200.             <top>33</top>
  201.             <right>467</right>
  202.             <bottom>272</bottom>
  203.         </rect>
  204.         <style>opaque</style>
  205.         <showName> <false /> </showName>
  206.         <highlight> <false /> </highlight>
  207.         <autoHighlight> <false /> </autoHighlight>
  208.         <sharedHighlight> <true /> </sharedHighlight>
  209.         <family>0</family>
  210.         <titleWidth>0</titleWidth>
  211.         <icon>0</icon>
  212.         <textAlign>center</textAlign>
  213.         <font>Chicago</font>
  214.         <textSize>12</textSize>
  215.         <textStyle>plain</textStyle>
  216.         <name></name>
  217.         <script></script>
  218.     </part>
  219.     <content>
  220.         <layer>background</layer>
  221.         <id>2</id>
  222.         <text>RomMaker Menus</text>
  223.     </content>
  224.     <content>
  225.         <layer>background</layer>
  226.         <id>3</id>
  227.         <text>p. 11 of 15</text>
  228.     </content>
  229.     <content>
  230.         <layer>background</layer>
  231.         <id>7</id>
  232.         <text>   Make      Data-DAT Image      WCD-ROM Hard Disk Image      CD-ROM from WCD-ROM Hard Disk Image      Icon-only Image      Icon Database from Icon-only Image   Emulate      Emulating Apple & ISO Volumes      Collecting & Reporting Usage Statistics      Allow Changes to current image    Examine   Utilities      Copying & Comparing Images      Format WCD-ROM Hard Disk      Generate CD-ROM Drive Characteristics</text>
  233.     </content>
  234.     <content>
  235.         <layer>card</layer>
  236.         <id>2</id>
  237.         <text>For information on a menu item, click it.</text>
  238.     </content>
  239.     <content>
  240.         <layer>background</layer>
  241.         <id>22</id>
  242.         <text>11</text>
  243.     </content>
  244.     <name>RomMaker Menus</name>
  245.     <script></script>
  246. </card>
  247.  
  248.  
  249. card_34092.xml
  250. <?xml version="1.0" encoding="utf-8" ?>
  251. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  252. <card>
  253.     <id>34092</id>
  254.     <filler1>0</filler1>
  255.     <cantDelete> <false /> </cantDelete>
  256.     <showPict> <true /> </showPict>
  257.     <dontSearch> <false /> </dontSearch>
  258.     <owner>31568</owner>
  259.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  260.     <content>
  261.         <layer>background</layer>
  262.         <id>2</id>
  263.         <text>ROM Content File</text>
  264.     </content>
  265.     <content>
  266.         <layer>background</layer>
  267.         <id>3</id>
  268.         <text>p. 10 of 15</text>
  269.     </content>
  270.     <content>
  271.         <layer>background</layer>
  272.         <id>7</id>
  273.         <text><span class="style1">ach CD-ROM that you publish must have its own title file and ROM Content File. The content specification phase of creating a CD-ROM requires you to create an ASCII text script file, using either your own editor, say Teachtext or the editor supplied with RomMaker. RomMaker requires all Rom Content script files to be in ASCII text format. Hence, if you use your own editor, all script files must be saved as ASCII text.Syntax of the ROM Content file:For each file or folder that you want to put on a CD-ROM, the content specification script must contain a single-line entry containing the following information:      ΓÇó  The name of the source file/folder on your hard disk or network. This tells      RomMaker where to look for the files when making the CD-ROM.      ΓÇó  The name of the destination file/folder on the CD-ROM. This tells RomMaker      where to put the file on the CD-ROM and what to call it.Each content entry has the following structured textual format:     "Source File/Folder Name"  "CD-ROM File/Folder Name" <Optional Flags>The Rom Content script format mandates that each line must have a source filename and a CD-ROM filename. RomMaker will flag an error for each line which doesn't meet this requirement. For example, if you specify a line where the source file resides on an unknown disk, RomMaker will signal an error since it cannot find the file. This feature is particularly important in network environments, where you may have specified a Rom Content file with network files but have not yet connected to it.There are two mandatory paramaters and one or more optional parameters (called flags) you must specify for each file/folder you wish to put on a CD-ROM. As an example, suppose you wanted to make a simple CD-ROM containing just two files - the source file 'Home' is to be called 'Home Stack' in the root folder of the CD-ROM and the file 'Hypercard' is to be placed in the folder 'Applications' on the CD-ROM. Let us say that both these files reside on our 'Macintosh HD' volume inside the 'Card' folder. The content specification file would contain the following two textual lines which you would input:     "Macintosh HD:Card:Home"     ":Home Stack"     "Macintosh HD:Card:Hypercard"     ":Applications:Hypercard"Note the use of the double quote delimiter to separate the source file name and CD-ROM file name token. Since an Apple filename can contain space and other non alphanumeric characters, the double quote delimiter is used to specify the bounds of the source filename and destination filename.In the above example, the files 'Home' and 'Hypercard' located in the 'Card' folder on the volume 'Macintosh HD' will be copied to the CD-ROM. The file 'Home' will be moved to the root of the volume and renamed 'Home Stack' on the CD-ROM while the file Hypercard will be resident under a folder on the CD-ROM called 'Applications'.  This process of specifying files can be cumbersome if you have to individually specify every file that goes into the CD-ROM. However this is not usually the case since it is likely that your source files are orgainzed into some logical structure and you will in fact be copying groups of files located in specific folders. You can use the scripting system to specify a set of files per line. For example, suppose you wanted to transfer all the files in your CARD folder to a CD-ROM folder called 'Hypercard' folder on the CD-ROM. The content definition file would contain the following entry:     "Macintosh HD:Card"     ":Hypercard"RomMaker will search the 'Card' folder of the volume 'Macintosh HD' for each file and put those files into the 'Hypercard' folder on the CD-ROM. You can also copy complete folder trees using a single line specification in your content specification file. To illustrate, suppose you want to make a copy of two of your volumes 'Macintosh HD' and 'Second Volume' on a CD-ROM. Your Rom Content file would contain the following line:     "Macintosh HD:"     ":Primary Volume"  -f     "Second Volme:"     ":Secondary Volume"  -fThe '-f', called the 'folder' flag, tells RomMaker that you want to copy the volume/folder 'Macintosh HD:' in whole with any files or folder underneath the root folder to a CD-ROM folder structure whose top is the folder 'Primary Volume'. The second line in the content specification file simply copies the volume 'Second Volume' to the CD-ROM folder 'Secondary Volume'. In a later section, we will see how other flags can be helpful in specifying other attributes such as hide files/folders or timestamp. Note that these flags are optional.RomMaker ignores all lines that begin with a semi-colon ';'. Use this feature to insert comments in your Rom Content file as documentation.Each Rom Content file entry can contain one or more flags that further define the file attributes of both the source file and the file to be put on the CD-ROM. Note that each flag will only be valid for the file specification on that line. As soon as RomMaker encounters a new script line in the Rom Content file, it automatically reverts to the default attributes specified in the title form.The general format of a flag is the '-' character, followed by a </span><span class="style7">lower case</span><span class="style1"> letter which defines the flag, followed by one or more parameters.  The following flags are legal: </span><span class="style8">-f</span><span class="style1"> The -f  or subfolder flag searches the folder tree for all files matching the input file specification. The following command will cause RomMaker to copy all files and folders under the folder 'Doc Data' to a CD-ROM folder 'CD Doc Data':         "Macintosh HD:Doc Data"   ":CD Doc Data"       -f </span><span class="style8">-t</span><span class="style1">The -t or timestamp flag followed by a date and time defines the date and time stamp for the group of files defined by the source file specification. The following command will cause RomMaker to copy the file 'RomMaker Doc" to the CD-ROM root with its time stamp set to December 31st 1990 at 12:00pm:    "HD:Doc:RomMaker Doc"        ":"     -t 12\31\90 12:00 </span><span class="style8">-o</span><span class="style1">The -o or output file flag, followed by one of the attribute types 'n' or 'h', sets the attributes of the output file created on the CD-ROM. On a CD-ROM, you can have normal or hidden files; system files aren't applicable and the read-only flag is always set due to the physical properties of a CD-ROM. The n [normal] or h [hidden] attribute selector overrides any title defaults. The following command will cause RomMaker to copy and hide the file PASSWORD in the CD-ROM root folder:    "HD:Password"        "Password"     -oh</span><span class="style8">-k</span><span class="style1">The -k or keep flag is used to keep the date and time stamp of the original source file. When RomMaker makes a CD-ROM, it uses the defaults specified in the title form for the files as its date and time stamp if you turned the 'keep' attributes check box off. The -k flag lets you override this and keep the original time stamp on specific files/folders. To keep the timestamps on all files, use the Keep Timestamp option in the title form (instead of flagging each line in your Rom Content file).</span><span class="style8">-m</span><span class="style1">The -m or marked flag is used to exclude files from a particular search path. To illustrate, suppose that you have folder tree containing some 2000 files and 100 directories most of which you wish to place on a CD-ROM but wish to exclude say 10 folders/files from this search path. The -m or marked flag tells the RomMaker to ignore all filenames/folders whose first and last character of the name are '(' and ')' respectively. Hence all you have to do is to go and bracket the names of the files/folders using the finder and use the -m flag in your script file. For example, suppose you have a folder 'Rom Data' that contains a file called 'Dont Want' which is not be placed on the CD-ROM. You would change the name of this file to '(Dont Want)' and then script the following line in your Rom Content file.    "HD:Rom Data"  ":Rom Data" -f -mThe -m instructs RomMaker to ignore all files/folders whose first character is '(' and last character is ')';</span><span class="style8"> -v</span><span class="style1">The -v or version flag is used if your source of data is an ISO 9660 CD-ROM. The filenames on these CD-ROMs have a version number appended to their name. For example, the file "MYFILE.TXT" will show up as "MYFILE.TXT;1" when mounted on a Macintosh. This flag simply instructs the RomMaker to remove the version number from the filename when it puts it out on the HFS CD-ROM. </span><span class="style8">-i</span><span class="style1">The -i or icon flag enables you to specify an icon for the CD-ROM you make. System 7 allows you to define an Icon for any CD-ROM. To enable this feature, simply create a file containing the icon using ResEdit and then specify this file in the script with the -i flag. e.g.     "HD:CDROM Icon"  -i     "Source:Folder" ":Rom Folder" -f     ...     ...Note that if you are copying a complete hard disk volume which has its own icon, RomMaker will automatically copy that icon to the CD-ROM image unless it finds a script line with the -i flag.When RomMaker sees the -i flag, it simply opens up the file's resource fork and uses the first icon it finds in the resource fork as the Volume Icon for the CD-ROM. Hence to create a CD-ROM icon, simply create a file using ResEdit and insert the Volume Icon you want into that file. Then specify that file in your script and RomMaker will do the rest.</span><span class="style8">-x</span><span class="style1">The -x or exclude flag is used only in dual mode CD-ROMs which have both the ISO and Apple HFS file systems on the same CD-ROM. Since a dual mode CD-ROM has two partitions, you may wish to select whether a set of files/folders need to be excluded from a particular file system. The format for this is demonstrated below:     "HD:Mac folder"     "Mac folder"     -f     -x ISO     "HD:DOS folder"     "DOS folder"     -f      -x HFS     "HD:Both folder"     "Both folder"     -fIn the above script, the first line in the script uses the -x (exclude) flag to instruct the RomMaker not to enter these files into the ISO 9660 file system partition since they are clearly Macintosh files. In the second line, the -x flag is used to ensure that the files are not found in the HFS partition. The last line where no -x flag is found (the default)  means that the files in that folder are found in both partition.When a dual mode CD-ROM is made, a particular file is copied only once and both the file system entries point to just this once occurrence of the file on the CD-ROM. As a result, if the files are common to both Apple HFS and ISO 9660, each partition appears to hold the maximum allowed per CD-ROM, upto 680MB of data. You can have as many flags as you want on each command line. For example, the Rom Content script line     "Mac HD:Secret Folder"     ":Password"      -oh -t 01\01\91 12:00 -f -k -mwill search the folder tree under 'Secret Folder' for all files excluding all marked files and copy them to the  'Password' folder on the CD-ROM where all the files are hidden and timestamped January 1, 1991 12:00 pm.By combining optional flags on each Rom Content file entry, RomMaker supports a powerful mechanism for building your CD-ROM folder structure efficiently and to your satisfaction.</span></text>
  274.     </content>
  275.     <content>
  276.         <layer>background</layer>
  277.         <id>22</id>
  278.         <text>10</text>
  279.     </content>
  280.     <name>ROM Content File</name>
  281.     <script></script>
  282. </card>
  283.  
  284.  
  285. card_33915.xml
  286. <?xml version="1.0" encoding="utf-8" ?>
  287. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  288. <card>
  289.     <id>33915</id>
  290.     <filler1>0</filler1>
  291.     <cantDelete> <false /> </cantDelete>
  292.     <showPict> <true /> </showPict>
  293.     <dontSearch> <false /> </dontSearch>
  294.     <owner>31568</owner>
  295.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  296.     <content>
  297.         <layer>background</layer>
  298.         <id>2</id>
  299.         <text>Misc Options</text>
  300.     </content>
  301.     <content>
  302.         <layer>background</layer>
  303.         <id>3</id>
  304.         <text>p. 9 of 15</text>
  305.     </content>
  306.     <content>
  307.         <layer>background</layer>
  308.         <id>7</id>
  309.         <text>WHEN EMULATINGWhen RomMaker uses a disk or tape image to emulate a CD-ROM, it needs to know which physical CD-ROM drive it should mimic.  This field allows you to specify the physical drive to emulate on a title-by-title basis. RomMaker comes with a set of drives whose characteristics are known; you can pick from one of this set or generate your own characteristics file using the "Generate CD-ROM drive characteristics..." item in the "Emulate" menu.USAGE STATISTICS FILEThis field allows you to specify where RomMaker will create the next usage statistics file for this title file.  If you leave this field blank, the file will be created in the "LOG" folder within the RomMaker folder, and will have the same name as the volume name, followed by ".STAT".  For more information on the usage statistics file, see the help section on the Emulate menu.LOG FILEThis field allows you to specify where RomMaker will create the next log file for this title file.  If you leave this field blank, the file will be created in the "LOG" folder within the RomMaker folder, and will have the same name as the volume name, followed by ".LOG".  For more information on the log file, see the help section on the Examine menu.ERROR FILEThis field allows you to specify where RomMaker will create the next error file for this title file.  If you leave this field blank, the file will be created in the "LOG" folder within the RomMaker folder, and will have the same name as the volume name, followed by ".ERR".  For more information on the log file, see the help section on the Examine menu.ICON DATABASE FILEThis field allows you to specify where RomMaker will create the next icon database file for this title file.  If you leave this field blank, the file will be created in the "DFN" folder within the RomMaker folder, and will have the same name as the volume name, followed by " ICON DB" (note the two spaces).  For more information on the icon database file, see the help section on the Emulate menu.</text>
  310.     </content>
  311.     <content>
  312.         <layer>background</layer>
  313.         <id>22</id>
  314.         <text>9</text>
  315.     </content>
  316.     <name>Misc Options</name>
  317.     <script></script>
  318. </card>
  319.  
  320.  
  321. card_33704.xml
  322. <?xml version="1.0" encoding="utf-8" ?>
  323. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  324. <card>
  325.     <id>33704</id>
  326.     <filler1>0</filler1>
  327.     <cantDelete> <false /> </cantDelete>
  328.     <showPict> <true /> </showPict>
  329.     <dontSearch> <false /> </dontSearch>
  330.     <owner>31568</owner>
  331.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  332.     <content>
  333.         <layer>background</layer>
  334.         <id>2</id>
  335.         <text>Date, Time, & Attributes</text>
  336.     </content>
  337.     <content>
  338.         <layer>background</layer>
  339.         <id>3</id>
  340.         <text>p. 8 of 15</text>
  341.     </content>
  342.     <content>
  343.         <layer>background</layer>
  344.         <id>7</id>
  345.         <text><span class="style1">OLUME ATTRIBUTESEach CD-ROM must have a CD-ROM creation date and time stamp. However, it may also have a date and time modified field, which specifies the last date and time the volume was modified. This field typically contains the same data as the date and time created field, but may be different if for example you decide to issue an update to a previously created CD-ROM. Most applications do not use this field.</span><span class="style2">Expiration Date & Time</span><span class="style1">This field tells the retrieval software when this CD-ROM becomes obsolete. DOS ignores this field; it is for use by your retrieval software. This field is sometimes used in regular publishing applications where the most recent CD-ROM must be used. The retrieval software would, in such a case, check the expiration date on the CD-ROM and tell the user that this CD-ROM had become obsolete.</span><span class="style2">Effective Date & Time</span><span class="style1">This field tells the retrieval software when to activate this CD-ROM; it complements the expiration date and time. For a regular publishing cycle, this field would typically be set to the expiration date and time of the previous CD-ROM in the series.FILE & FOLDER ATTRIBUTESRomMaker allows you to control two attributes for each file and folder that it creates on the CD-ROM:  Visible/Hidden, and the file/folder creation date & time.</span><span class="style2">Keep/Override</span><span class="style1">If you don't need to control the attributes on your CD-ROM files & folders, use "Keep attributes..."; otherwise, use "Override..." to instruct RomMaker to use the specified attributes.  You can even override the override for any particular file or group of files, by using the optional "-k" flag in the appropriate line of the ROM Content File (see ROM Content File Format).</span><span class="style2">Hidden</span><span class="style1">Using this option instructs RomMaker to force all files/folders on this CD-ROM to be hidden, meaning they won't show up when the browsing the CD-ROM after it is produced. (Some CD-ROMs use this feature as a crude form of protection against illegal access by hiding all folders. Note, however, that there are several tools available that will display such files and folders, so this is not a very secure protection method.)If you want most but not all of your files/folders to be hidden, the ROM Content File format allows you to override this option line-by-line as well (see ROM Content File Format).</span><span class="style2">Date and Time</span><span class="style1">These attributes apply to all files and folders created by RomMaker. If you leave these unfilled, the values in the volume creation and date and time fields are used.</span></text>
  346.     </content>
  347.     <content>
  348.         <layer>background</layer>
  349.         <id>22</id>
  350.         <text>8</text>
  351.     </content>
  352.     <name>Date, Time, & Attributes</name>
  353.     <script></script>
  354. </card>
  355.  
  356.  
  357. card_33363.xml
  358. <?xml version="1.0" encoding="utf-8" ?>
  359. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  360. <card>
  361.     <id>33363</id>
  362.     <filler1>0</filler1>
  363.     <cantDelete> <false /> </cantDelete>
  364.     <showPict> <true /> </showPict>
  365.     <dontSearch> <false /> </dontSearch>
  366.     <owner>31568</owner>
  367.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  368.     <content>
  369.         <layer>background</layer>
  370.         <id>2</id>
  371.         <text>System Info</text>
  372.     </content>
  373.     <content>
  374.         <layer>background</layer>
  375.         <id>3</id>
  376.         <text>p. 7 of 15</text>
  377.     </content>
  378.     <content>
  379.         <layer>background</layer>
  380.         <id>7</id>
  381.         <text>VOLUME SET IDENTIFIERThis parameter identifies the volume set that this CD-ROM belongs to. ISO allows you to produce multiple CD-ROMs that belong to the same volume set. This field is used to identify the volume set for this CD-ROM.SYSTEM IDENTIFIERThis specifies the name of a system that can act on the contents of a reserved area of the CD-ROM called the System Area (which we will examine shortly); you can use up to 32 characters. The system identifier is used in identifying the software system that can understand how to interpret the system area of the CD-ROM.APPLICATION BLOCK FILEThis specifies a file on your hard disk or network whose contents will be copied into the Application Use area of the CD-ROM volume identifier. Each volume identifier on a CD-ROM contains 512 bytes where you can put any information in any format. RomMaker allows you to insert that information into this area via a file (ASCII or binary) which contains 512 or fewer bytes. RomMaker enforces this size rule by preventing you from specifying a file larger than this limit.SYSTEM AREA FILE(Note:  The System Area file is ignored for all ROM Standard settings except ISO 9660.) Each CD-ROM volume has 16 physical sectors (Sectors 0 to 15) located at the start of the CD-ROM which are reserved for special system use. Unlike the ISO-9660 file structure where data is related via directory and file entries, this area is physically identified by the sector number and contains 32768 or fewer bytes of ASCII or binary data (each sector is 2048 bytes). The ISO-9660 and Hi-Sierra standards specify that all volume data related through directory and file entries must start at Sector 16, leaving this gap of 32768 bytes where you may put binary data of your choice.Since the physical location of the System Area is guaranteed, you do not need any directory structure to access this data on the CD-ROM. One practical use is to put bootstrap code into this area, so a PC trying to boot from the CD-ROM can locate the boot record at physical location 0 of the CD-ROM.Like the Application Block field, the System Area field can accept the name of a DOS file on your hard disk to copy into Sectors 0 - 15 of the CD-ROM. RomMaker verifies that this file is smaller than 32768 bytes, the size of the System Area.FILL TO LOCATIONThis field is used for making multimedia CD-ROMs. Multimedia CD-ROMs have the audio component at a specified location following the data component. To successfully use the audio component, the retrieval software must know the location at which it begins. (Think what would happen if your software asked the CD-ROM player to play Mozart and some other type of music began to play!)The Fill To Location field tells RomMaker to pad the tape to the exact sector where the audio component beginsΓÇöeven if the data component does not take up all that space. You will then be able to ship a RomMaker DAT cartridge containing the data component as well as an audio tape containing your audio components to your mastering plant, which will insert the audio component immediately after this location. The Fill To Location field specifies this audio start location in terms of blocks, where each block contains 2048 bytes.RomMaker ensures that any data you put will fit into the area from the start of CD-ROM to the Fill To Location. If your files don't fit, RomMaker will stop during the pre-mastering phase of the CD-ROM process.MAXIMUM ROM SIZEThe maximum size of a CD-ROM is 664Mb, or 72 minutes and 2 seconds. You may wish to limit your CD-ROM to a smaller size, especially if your user population has older CD-ROM drives which often have problems reading areas past 60 minutes and 2 seconds. Newer drives do not have this problem, and can read the maximum potential of 660MB. If your files don't fit, RomMaker will stop during the pre-mastering phase of the CD-ROM process.LOGICAL BLOCK SIZEThis field is currently not editable; it is set to 2048 bytes.</text>
  382.     </content>
  383.     <content>
  384.         <layer>background</layer>
  385.         <id>22</id>
  386.         <text>7</text>
  387.     </content>
  388.     <name>System Info</name>
  389.     <script></script>
  390. </card>
  391.  
  392.  
  393. card_33105.xml
  394. <?xml version="1.0" encoding="utf-8" ?>
  395. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  396. <card>
  397.     <id>33105</id>
  398.     <filler1>0</filler1>
  399.     <cantDelete> <false /> </cantDelete>
  400.     <showPict> <true /> </showPict>
  401.     <dontSearch> <false /> </dontSearch>
  402.     <owner>31568</owner>
  403.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  404.     <content>
  405.         <layer>background</layer>
  406.         <id>2</id>
  407.         <text>Publication Info</text>
  408.     </content>
  409.     <content>
  410.         <layer>background</layer>
  411.         <id>3</id>
  412.         <text>p. 6 of 15</text>
  413.     </content>
  414.     <content>
  415.         <layer>background</layer>
  416.         <id>7</id>
  417.         <text>PUBLISHER INFOThis specifies the publisher of the CD-ROM; you can use up to 128 characters. Note that for many of these fields, the ISO 9660 and Hi-Sierra standards recognize only a limited character set, called the "A" character set:              A to Z (uppercase only)              0 to 9              Space, ! , " , % , & , ', ( , ) , * , +              Comma , - , . , / , : , ;, < , = , > , ?, _Thus the text "THE SMALL SCALE PUBLISHER & FRIENDS INC." would be allowed, while the text "PUBLISHER [LTD]" would not, since the [ and ] characters are not valid. RomMaker will signal an error if any invalid characters are entered in this field.If the publisher's name is longer than 128 characters, both the ISO and Hi-Sierra standards allow you to specify a filename in this field. This file must be placed on the CD-ROM at the root directory; it can contain as much information about the publisher as you need. To specify a file, the first character of this field must be an '_' character followed by the eight-character filename and the three-character file extension. For example, the text _PUBLISH.TXT in this field indicates that the publisher description is found in a file PUBLISH.TXT located in the root directory of the CD-ROM. RomMaker will signal an error if this file does not exist when you are premastering the CD-ROM.DATA PREPARER INFOThis specifies the person or entity that prepared the CD-ROM. You can use up to 128 characters. This is useful if you are using RomMaker to prepare CD-ROMs for other people such as where the Publisher is different than the Data Preparer. This field has the same attributes as the Publisher Info field (above), in that it can contain only characters from the "A" character set, and an underscore '_' followed by a filename can be used to extend the field contents.APPLICATION INFOThis specifies an identifier describing the application that is recorded on this CD-ROM; you can use up to 128 characters. This field has the same attributes as the Publisher Info field (above), in that it can contain only characters from the "A" character set, and an underscore '_' followed by a filename can be used to extend the field contents.COPYRIGHT FILEThis specifies a file to be placed in the root directory of the CD-ROM which contains a copyright statement regarding the contents of the CD-ROM. An ISO-9660 or Hi-Sierra filename consists of an eight-character filename and a three-character or less file extension, separated by the '.' character. Only the characters A-Z, 0-9 and '_' (called the "D" character set) can be used in the filename and extension. If you specify this file, RomMaker will check whether you have included this file in your root directory when you pre-master the CD-ROM.ABSTRACT FILEThis specifies a file to be placed in the root directory of the CD-ROM which contains an abstract statement regarding the contents of the CD-ROM. This is analogous to the abstract on the back cover of a book. Only the characters A-Z, 0-9 and '_' (called the "D" character set) can be used in the filename and extension. If you specify this file, RomMaker will check whether you have included this file in your root directory when you pre-master the CD-ROM.BIBLIOGRAPHIC FILEThis specifies a file to be placed in the root directory of the CD-ROM which contains bibliographic records interpreted according to standards agreed upon between the publisher and the user. This is analogous to the bibliographic summary found on the inside of a book, allowing the book to be classified by author and subject. Only the characters A-Z, 0-9 and '_' (called the "D" character set) can be used in the filename and extension. If you specify this file, RomMaker will check whether you have included this file in your root directory when you pre-master the CD-ROM.NOTE: The Hi-Sierra standard does not support the Bibliographic File field.</text>
  418.     </content>
  419.     <content>
  420.         <layer>background</layer>
  421.         <id>22</id>
  422.         <text>6</text>
  423.     </content>
  424.     <name>Publication Info</name>
  425.     <script></script>
  426. </card>
  427.  
  428.  
  429. card_32838.xml
  430. <?xml version="1.0" encoding="utf-8" ?>
  431. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  432. <card>
  433.     <id>32838</id>
  434.     <filler1>0</filler1>
  435.     <cantDelete> <false /> </cantDelete>
  436.     <showPict> <true /> </showPict>
  437.     <dontSearch> <false /> </dontSearch>
  438.     <owner>31568</owner>
  439.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  440.     <content>
  441.         <layer>background</layer>
  442.         <id>2</id>
  443.         <text>Apple HFS Info</text>
  444.     </content>
  445.     <content>
  446.         <layer>background</layer>
  447.         <id>3</id>
  448.         <text>p. 5 of 15</text>
  449.     </content>
  450.     <content>
  451.         <layer>background</layer>
  452.         <id>7</id>
  453.         <text>DESKTOP MANAGEMENTThe Finder "Desktop" file is where the Macintosh keeps information about file and folder positions, window sizes and positions, which folders are open, etc.  If you are making a CD-ROM that you know will be used only by Macintosh computers using System 7.0 or later, use the "System 7 only" option to save space on the CD-ROM.  Otherwise it's safest to use the "System 6 and System 7" option.DESKTOP ITEMSThe Macintosh system has the ability to place files and folders on the desktop, that is, on the "background" area of the Macintosh screen, visually outside any disk or folder.  When creating CD-ROMs for use by others, it's usually best to make sure any files and folders you have are not on the desktop, because it can be confusing to users if, when they insert a new disk, new items suddenly pop up on their desktop.  However, RomMaker allows you to copy such items (using the "Copy" option will do this) if it encounters them in the ROM Content File.  If, however, you want to make sure you don't inadvertently put any desktop items on your CD-ROM, just use the "Stop" option.If "Ignore" is used, any item found on the desktop during processing will be ignored, but RomMaker will continue processing the CD-ROM.  Thus, if you want to temporarily hide a file or folder from RomMaker (without having to adjust the ROM Content File) you can just put it on the desktop and use the "Ignore" option.ICON MANAGEMENTRomMaker allows you to create a special "icon-only" image, using which you can set up your file, folder, and window positions just the way you want them. For more info on that topic, see help on the Make menu, under "Icon-only Image".The icon management section of the title file allows you to choose whether you want to use the icon database that the Make menu lets you create, and if so, how you want RomMaker to react when it finds a file or folder that doesn't have a corresponding entry in the icon database. You might want to use the "stop" option in this case, because it means that a file or folder was added to your source files between the making of the image and the making of the current CD-ROM.ALIAS MANAGEMENTThe Macintosh Finder, using System 7 or later, allows users to create "aliases" to files and folders. An alias represents the file or folder it was created with, in the sense that if you double-click an alias, the original file or folder will be opened. The alias is not really a copy of the item; rather it "points" to the original item in a way that the Macintosh file system can understand.  For more info on aliases in general, see your Macintosh documentation.Use of aliases on CD-ROMs can be a great convenience for your System 7 users, because they can make tedious browsing of the CD-ROM folders unnecessary. RomMaker allows several options for dealing with aliases:  if you use the "Resolve Aliases" option, RomMaker will automatically resolve aliases as it finds them.  Resolving an alias means making it point to the item on the CD-ROM instead of to the original item on your hard disk or network.  That way if a user double-clicks an alias on his CD-ROM, his Macintosh will be able to open the "original" on his CD-ROM, rather than trying to look on your hard disk or network, which of couse will probably not be available at the time.If the "Resolve Aliases" option is used, there is the possibility that RomMaker will encounter an alias whose original is not on the list of files to be copied on the CD-ROM. In that case, the alias is said to be "non-convertible". RomMaker allows you to either stop processing if such an alias is encountered, or ignore such aliases altogether (meaning they will not be copied to the CD-ROM).</text>
  454.     </content>
  455.     <content>
  456.         <layer>background</layer>
  457.         <id>22</id>
  458.         <text>5</text>
  459.     </content>
  460.     <name>Apple HFS Info</name>
  461.     <script></script>
  462. </card>
  463.  
  464.  
  465. card_32702.xml
  466. <?xml version="1.0" encoding="utf-8" ?>
  467. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  468. <card>
  469.     <id>32702</id>
  470.     <filler1>0</filler1>
  471.     <cantDelete> <false /> </cantDelete>
  472.     <showPict> <true /> </showPict>
  473.     <dontSearch> <false /> </dontSearch>
  474.     <owner>31568</owner>
  475.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  476.     <content>
  477.         <layer>background</layer>
  478.         <id>2</id>
  479.         <text>Volume Info</text>
  480.     </content>
  481.     <content>
  482.         <layer>background</layer>
  483.         <id>3</id>
  484.         <text>p. 4 of 15</text>
  485.     </content>
  486.     <content>
  487.         <layer>background</layer>
  488.         <id>7</id>
  489.         <text><span class="style1">OLUME LABELThis label uniquely identifies the CD-ROM. It is analogous to a book's title on the front cover. Note that although this field can hold up to 32 characters, MS-DOS systems will recognize only the first 11 characters.ROM CONTENT FILEThis is the name of the file that tells RomMaker which files from your hard disk or network you want to put on the CD-ROM, and where they should go. This is an ASCII text file that you must create using a word processor or text editor (RomMaker's or your own).  The complete format description allows for many options, but in general there is one line in the ROM Content File for each file or group of files you want to put on your CD-ROM.ROM STANDARDThis field tells RomMaker which directory structure and layout standard to use when making this CD-ROM. There are two recognized standards for specifying directory structure and layout for CD-ROMs:  ISO 9660 and Hi-Sierra. The first standard to evolve, Hi-Sierra, was adopted across the United States. Later, the International Standards Organization (ISO) established ISO 9660 as an international standard, which is a superset of the Hi-Sierra format, and is more commonly used today.  Unless you have a specific reason to use Hi-Sierra format, you should probably use Alternatively, RomMaker allows you to make CD-ROMs that use Apple HFS format, which preserves all desktop information such as window sizes and positions, icons, etc. for CD-ROMs meant to be used on Apple Macintosh systems.Finally, there is the combined Apple HFS/ISO 9660 format.  This format allows one set of data files to be recognized by systems that read either HFS or ISO formats; in other words, you can create a single CD-ROM that can be read either by a Macintosh or MS-DOS system!  The way this works is that RomMaker creates both HFS and ISO directory structures and points them to the same data files on the CD-ROM.FILENAME STANDARDDifferent ROM standards (see above) have different requirements for file and directory/folder names (collectively referred to as "filenames"). If the ROM Standard setting you are using refers to ISO 9660 or Hi-Sierra, it is possible that you could specify a file to be copied to the ROM image whose name is not allowed under that ROM Standard setting.The Filename Standard option tells RomMaker what to do in such a situation. You have the choice of three different filename standards for RomMaker to use, meaning that it will signal an error if it encounters a file whose name doesn't conform to the requirements of the current Filename Standard setting. Or you can also specify that RomMaker should attempt to automatically convert such names during processing (this may lead to duplicate filename errors, however, and should only be used if you thoroughly understand the consequences).Note that the Filename Standard setting applies only to file and directory names in an ISO partition; that is, it doesn't apply to Apple HFS ROMs, nor does it apply to the Apple HFS partition of an Apple HFS/ISO 9660 ROM.</span><span class="style2">MS-DOS</span><span class="style1">This option should be used with caution since it can produce a non-ISO-standard CD-ROM. In this case, all ISO 9660/Hi-Sierra filename enforcement is turned off and the original DOS filename is used on the CD-ROM. The CD-ROM thus produced is not ISO 9660/Hi-Sierra compliant. However, Microsoft extensions MSCDEX do allow you access to this CD-ROM since its volume structure still conforms to the standard. It's interchange capability with other systems is of course not guarantied. Occasionally you may even have problems reading this CD-ROM with MSCDEX.NOTE:  Use this option only as a last resort and only if you clearly understand the nonstandard nature of the CD-ROM you are producing. This option also turns off the eight directory level limit on an ISO 9660/Hi-Sierra CD-ROM and allows you to use extension names in directories.If you invoke the Auto-Convert or DOS filename option, a warning will pop up each time you attempt to make a CD-ROM. A similar warning message stating the number of files that were converted or non-standard is also displayed upon termination of the processing.You can locate each filename which was either converted or non-standard by examining the log file produced when you make a CD-ROM. For each such file, an asterisk (*) is added to the attribute field to identify the file.</span><span class="style2">ISO 9660 Level 1</span><span class="style1">This option produces a CD-ROM that exactly conforms to the "D" standard, meaning that file and directory names must be made up of only the "D" character set, which allows only the characters A-Z, 0-9 and the '_' (underscore) character. In addition, file and folder names are limited to a 1-8 character root and a 0-3 character extension (like MS-DOS filenames).If RomMaker encounters an "illegal" file or directory name during processing, it will signal an error, unless the file/directory is explicitly dealt with in the ROM Content File (see), or the Auto-Convert option (see below) is in use.</span><span class="style2">ISO 9660/Hi-Sierra</span><span class="style1">This option produces a CD-ROM that exactly conforms to the "D" standard, meaning that file and directory names must be made up of only the "D" character set, which allows only the characters A-Z, 0-9 and the '_' (underscore) character. In addition, this option allows filenames up to 33 characters long, in contrast to the ISO 9660 Level 1 option which allows no more than 11 characters in a filename.If RomMaker encounters an "illegal" file or directory name during processing, it will signal an error, unless the file/directory is explicitly dealt with in the ROM Content File (see), or the Auto-Convert option (see below) is in use.</span><span class="style2">Auto-Convert</span><span class="style1">Checking this option invokes the filename conversion feature of the RomMaker that automatically converts any non-standard filenames to ISO 9660/Hi-Sierra-compliant names on the basis of a simple rule:  Every character other than A-Z, 0-9 and '_' (underscore) in a filename is changed to an underscore character.For example, if Auto-Convert is used, the filename 'MY-FILE~.$$$' would get changed to 'MY_FILE_.___' . The CD-ROM produced after this conversion is ISO 9660/Hi-Sierra-compliant, since all the filenames use only the required "D" character set.  If you use this option, you must take special care to verify that your software is operating correctly in all cases since it may be expecting the DOS filename and not the converted ISO 9660 filename.The most common error with this option is the "Duplicate file name found" error. This occurs if there is already a CD-ROM filename with the same name as that produced by automatic conversion. For example, suppose you had two files in a directory called MYFILE.___ and MYFILE.$$$ respectively. During automatic conversion the filename MYFILE.$$$ would get changed to MYFILE.___ resulting in a duplicate filename error. When this happens, RomMaker automatically serializes the duplicate filenames; i.e., in this case, the second occurrence of MYFILE.___ would be renamed MYFILE.__1, and so on.</span></text>
  490.     </content>
  491.     <content>
  492.         <layer>background</layer>
  493.         <id>22</id>
  494.         <text>4</text>
  495.     </content>
  496.     <name>Volume Info</name>
  497.     <script></script>
  498. </card>
  499.  
  500.  
  501. card_32478.xml
  502. <?xml version="1.0" encoding="utf-8" ?>
  503. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  504. <card>
  505.     <id>32478</id>
  506.     <filler1>0</filler1>
  507.     <cantDelete> <false /> </cantDelete>
  508.     <showPict> <true /> </showPict>
  509.     <dontSearch> <false /> </dontSearch>
  510.     <owner>31568</owner>
  511.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  512.     <content>
  513.         <layer>background</layer>
  514.         <id>2</id>
  515.         <text>Title File</text>
  516.     </content>
  517.     <content>
  518.         <layer>background</layer>
  519.         <id>3</id>
  520.         <text>p. 3 of 15</text>
  521.     </content>
  522.     <content>
  523.         <layer>background</layer>
  524.         <id>7</id>
  525.         <text>The Title File is the primary document displayed when you use the Personal RomMaker.  It specifies all the parameters that the RomMaker software needs to create CD-ROM images and write-once CD discs tailored to your exact needs.  You can have several title filesΓÇöone for each CD-ROM "title" you regularly produce (although you can only work with one title file at a time).Each tab at the bottom of the title file window allows you to view and edit a different section of the title file; just click the tab to go to that section.  The only required parameters in the entire title file are the "Volume Label" and "ROM Content File" (both in the "Volume Info" section); all other sections of the title file can be left blank or as the standard RomMaker values.Title files are created and saved using the standard Macintosh File menu.</text>
  526.     </content>
  527.     <content>
  528.         <layer>background</layer>
  529.         <id>22</id>
  530.         <text>3</text>
  531.     </content>
  532.     <name>Title File</name>
  533.     <script></script>
  534. </card>
  535.  
  536.  
  537. card_32163.xml
  538. <?xml version="1.0" encoding="utf-8" ?>
  539. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  540. <card>
  541.     <id>32163</id>
  542.     <filler1>0</filler1>
  543.     <cantDelete> <false /> </cantDelete>
  544.     <showPict> <true /> </showPict>
  545.     <dontSearch> <false /> </dontSearch>
  546.     <owner>31568</owner>
  547.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  548.     <content>
  549.         <layer>background</layer>
  550.         <id>2</id>
  551.         <text>Steps in Making a Write-Once CD</text>
  552.     </content>
  553.     <content>
  554.         <layer>background</layer>
  555.         <id>3</id>
  556.         <text>p. 2 of 15</text>
  557.     </content>
  558.     <content>
  559.         <layer>background</layer>
  560.         <id>7</id>
  561.         <text><span class="style1">fter your Personal RomMaker software and hardware are properly installed, creating CD-ROMs and CD-ROM images is straightforward. RomMaker has many features and options, but there are really five basic steps in the process:</span><span class="style2">1) Prepare a Title File</span><span class="style1">The title file is what you are looking at when you start up RomMaker. It has several sections, each having a tab at the bottom, allowing you to move from section to section. RomMaker can only open one title file at a time.</span><span class="style6">To create, open, and save title files, use the "File" menu as you would for any Macintosh application.</span><span class="style1">The title file specifies what attributes the CD-ROM volume will have, such as its name, size, creation time, etc. Most important, it specifies a ROM Content File (see step 2). Editing the title file is easyΓÇölike filling out a big formΓÇöand almost all of the title file has standard settings, so you don't have to learn it all right away; you are required to specify only the name of the volume and the ROM content file.</span><span class="style2">2) Prepare a ROM Content File</span><span class="style1">This file is a list of all the files and folders that will be copied from your hard disk (or the network, or anywhere else you like) to the CD-ROM. You can copy an entire disk with a single line in the content file, or you can pick only specific files and folders to copy.</span><span class="style6">To create a ROM Content file, go to the "Volume Info" section of the title file.  To learn about the format of the ROM Content file, see the help on "ROM Content File Format".</span><span class="style1"></span><span class="style2">3) Create a CD-ROM Image</span><span class="style1">RomMaker will use the Title and Content files you have prepared to create an "image" of the CD-ROM, that is, an exact copy on the RomMaker's own hard disk of what the actual CD will contain. You can use this image to test your CD content and format without having to create an actual CD, which can save a lot of time and money.</span><span class="style6">To create an image, use the "Make" menu.</span><span class="style1"></span><span class="style2">4) Test the CD-ROM Image</span><span class="style1">After creating an image, you can instruct RomMaker to have it mimic, or "emulate", an actual CD-ROM. This means that it will appear on the desktop just like the actual CD would if you inserted it into a CD-ROM drive. You can then open documents and applications, and run whatever tests you would use to verify whether the actual CD was satisfactory, only you'll be using the image instead. If the image is unsatisfactory, you can simply adjust the title and content files and make another imageΓÇöas many times as you like.</span><span class="style6">To test an image, use the "Emulate" menu.</span><span class="style1"></span><span class="style2">5) Make the Write-Once CD</span><span class="style1">After you have made an image that is satisfactory to you, you can create an actual Write-Once CD. The RomMaker will then copy the image on its internal hard disk onto the Write-Once CD to create a permanent CD-ROM, which you can use in any CD-ROM player that accepts the format you chose in the title file.</span><span class="style6">To make a write-once CD, use the "Make" menu.</span><span class="style1">There are, of course, many variations on the basic process. When testing the CD, RomMaker can mimic the characteristics of the CD-ROM drive of your choosing, and collect usage statistics so you can see what files are accessed on the CD-ROM during the test.  You can make an image on a digital tape or a hard disk file instead of on RomMaker's hard disk.  RomMaker also has special options for creating Apple Macintosh CD-ROMs, including the ability to adjust the layout of files, folders, and windows, by creating a special "icon-only" image, whose icons you can click and drag just as you would normally on the Macintosh.  All these are ways in which RomMaker can tailor your CD-ROMs to your exact needs.</span></text>
  562.     </content>
  563.     <content>
  564.         <layer>background</layer>
  565.         <id>22</id>
  566.         <text>2</text>
  567.     </content>
  568.     <name>Steps in Making a Write-Once CD</name>
  569.     <script></script>
  570. </card>
  571.  
  572.  
  573. card_31317.xml
  574. <?xml version="1.0" encoding="utf-8" ?>
  575. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  576. <card>
  577.     <id>31317</id>
  578.     <filler1>0</filler1>
  579.     <cantDelete> <false /> </cantDelete>
  580.     <showPict> <true /> </showPict>
  581.     <dontSearch> <false /> </dontSearch>
  582.     <owner>31568</owner>
  583.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  584.     <content>
  585.         <layer>background</layer>
  586.         <id>2</id>
  587.         <text>Introduction</text>
  588.     </content>
  589.     <content>
  590.         <layer>background</layer>
  591.         <id>3</id>
  592.         <text>p. 1 of 15</text>
  593.     </content>
  594.     <content>
  595.         <layer>background</layer>
  596.         <id>7</id>
  597.         <text>Welcome to the Personal RomMaker!We hope you will find this to be the easiest, fastest, most flexible and trouble-free way you can find to create CD-ROMs.  We who designed and wrote RomMaker are ourselves creators and users of CD-ROM products, and we have put into RomMaker the features and ease-of-use that we would demand from a product of its kind.RomMaker is designed for the experienced Macintosh user. You don't need to be a "techie", but if you are unfamiliar with the Macintosh system, you'll get more out of RomMaker if you at least go through the tutorial that came with your Macintosh, or spend some time learning and using Macintosh applications, or in some other way get some Mac experience. Or just have an "old hand" around to ask questions of. This will also help prevent your using up CD-ROM blanks unnecessarily, which, while not terribly expensive (around $40), aren't exactly free either!If this is your first experience creating a CD-ROM, we recommend that you read at least the next page:  "Steps in making a Write-Once CD".  This gives a brief overview of the typical sequence of operations, and give you a good idea of what to do next.</text>
  598.     </content>
  599.     <content>
  600.         <layer>background</layer>
  601.         <id>22</id>
  602.         <text>1</text>
  603.     </content>
  604.     <name>Introduction</name>
  605.     <script></script>
  606. </card>
  607.  
  608.  
  609. card_31032.xml
  610. <?xml version="1.0" encoding="utf-8" ?>
  611. <!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
  612. <card>
  613.     <id>31032</id>
  614.     <filler1>0</filler1>
  615.     <bitmap>BMAP_2461.pbm</bitmap>
  616.     <cantDelete> <false /> </cantDelete>
  617.     <showPict> <true /> </showPict>
  618.     <dontSearch> <false /> </dontSearch>
  619.     <owner>30973</owner>
  620.     <link rel="stylesheet" type="text/css" href="stylesheet_3323.css" />
  621.     <part>
  622.         <id>2</id>
  623.         <type>field</type>
  624.         <visible> <true /> </visible>
  625.         <dontWrap> <false /> </dontWrap>
  626.         <dontSearch> <true /> </dontSearch>
  627.         <sharedText> <false /> </sharedText>
  628.         <fixedLineHeight> <true /> </fixedLineHeight>
  629.         <autoTab> <false /> </autoTab>
  630.         <lockText> <true /> </lockText>
  631.         <rect>
  632.             <left>229</left>
  633.             <top>102</top>
  634.             <right>435</right>
  635.             <bottom>181</bottom>
  636.         </rect>
  637.         <style>shadow</style>
  638.         <autoSelect> <false /> </autoSelect>
  639.         <showLines> <false /> </showLines>
  640.         <wideMargins> <true /> </wideMargins>
  641.         <multipleLines> <false /> </multipleLines>
  642.         <reservedFamily> 0 </reservedFamily>
  643.         <titleWidth>0</titleWidth>
  644.         <icon>0</icon>
  645.         <textAlign>left</textAlign>
  646.         <font>Geneva</font>
  647.         <textSize>10</textSize>
  648.         <textStyle>plain</textStyle>
  649.         <textHeight>13</textHeight>
  650.         <name>prompt</name>
  651.         <script></script>
  652.     </part>
  653.     <content>
  654.         <layer>background</layer>
  655.         <id>11</id>
  656.         <text>Contents:</text>
  657.     </content>
  658.     <content>
  659.         <layer>background</layer>
  660.         <id>12</id>
  661.         <text>IntroductionSteps in Making a Write-Once CDTITLE FILE   Volume Info   Apple HFS Info   Publication Info   System Info   Date, Time, & Attributes   Misc OptionsROM CONTENT FILEROMMAKER MENUS   Make   Emulate   Examine   Utilities</text>
  662.     </content>
  663.     <content>
  664.         <layer>card</layer>
  665.         <id>2</id>
  666.         <text>For information on any topic, click it.Note:  While in RomMaker itself, you can click on any field label for help on that field.</text>
  667.     </content>
  668.     <name></name>
  669.     <script></script>
  670. </card>
  671.  
  672.  
  673.